home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / sparkl28.zip / SPARKLE.DOC < prev    next >
Text File  |  1991-05-24  |  68KB  |  1,449 lines

  1.  
  2.               ---------------------------------------------------               
  3.                 -----------------------------------------------                 
  4.                   -------------------------------------------                   
  5.                     ---------------------------------------                     
  6.                       -----------------------------------                       
  7.                         -------------------------------                         
  8.                           ---------------------------                           
  9.                             -----------------------                             
  10.                               -------------------
  11.                                 ---------------                                 
  12.  
  13.  
  14.                      SPARKLE           by         Rob W. Smetana
  15.                                                   and Pro~Formance
  16.  
  17.                                 ---------------
  18.                               -------------------                               
  19.                             -----------------------                             
  20.                           ---------------------------
  21.                         -------------------------------                         
  22.                       -----------------------------------                       
  23.                     ---------------------------------------                     
  24.                   -------------------------------------------                   
  25.                 -----------------------------------------------                 
  26.               ---------------------------------------------------               
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                   Sparkle  (tm)
  35.  
  36.  
  37.                           **  Version 2.8  (5/91)  **
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.         ===============================================================
  49.  
  50.             Copyright (C) 1990, Rob W. Smetana  All Rights Reserved
  51.  
  52.           132 Alpine Terrace  San Francisco, CA  94117 (415) 863-0530
  53.  
  54.             Sparkle, Pro~Formance, P~F, and P-Screen are Trademarks
  55.                               of Rob W. Smetana
  56.  
  57.         ===============================================================  
  58.                                                                            
  59.  
  60.       ====================================================================
  61.                                     Sparkle
  62.       ====================================================================
  63.  
  64.       Included are:  Sparkle.Exe     Main Program
  65.                      Sparkle.Doc     This brief manual
  66.                            *.Bat     Demo batch files (run SP-DEMO!!)
  67.                       M-Menu.Com     Main Menu for demo  \ created using our
  68.                       H-Menu.Com     Demo Horizontal menu ) 
  69.                       V-Menu.Com       "  Vertical    "  / P-Screen program
  70.  
  71.                     REGISTER.Exe     To instantly convert Shareware versions
  72.                                      into fully registered versions.
  73.  
  74.       Run:          SP-Demo.Bat      For a demo of all current options.
  75.  
  76.       Purpose:      To add a little sparkle to your day or your batch files.
  77.  
  78.                     A small program to provide MANY utilities useful in
  79.                     batch files, at the DOS command prompt, called from
  80.                     within other programs (via "shell"), etc.
  81.  
  82.                     Note that Sparkle gives you 3 different menu options.
  83.                     ASK can turn ANY screen into a menu.  The SCROLLING
  84.                     BAR menu option can turn any text screen into either
  85.                     a vertical or horizontal scrolling bar menu.
  86.                     
  87.                     Options currently include:
  88.                     ==========================
  89.                      * SCROLLING BAR MENUS   (turn ANY text screen into
  90.                        a vertical or horizontal Scrolling Bar Menu)
  91.  
  92.                      * ASK  (turn ANY screen into a menu, or use Ask
  93.                        just to pause; print a prompt on any row or column
  94.                        in any color; specify which keys are "valid.")
  95.  
  96.                      * Big! Font (tm) (print 8-line-high messages!)
  97.  
  98.                      * WINDOWS (250+ frame styles; with or without shadows)
  99.  
  100.                      * QUIKPRINT (print text anywhere in color)
  101.  
  102.                      * SOUND EFFECTS (from simple to elaborate)
  103.  
  104.                      * PAUSE (pause from 1/3 second to ??; you may also
  105.                        let the user press a key to bypass the pause.)
  106.  
  107.                      * MONITOR (which display adapter & monitor is active)
  108.  
  109.       For help:     For help, run Sparkle like this:   sparkle <Enter>.
  110.  
  111.                                                                             
  112.  
  113.  
  114.                                  WHAT'S NEW
  115.         ===============================================================
  116.  
  117.         IMPORTANT:  If you've used earlier versions of Sparkle, BE SURE
  118.         to note the changes to the Scrolling Bar menu option.  Bar menus
  119.         now offer MOUSE SUPPORT and no longer take a color parameter (they
  120.         now highlight options by reversing colors instead).
  121.  
  122.          Version   Date   What's New
  123.          -------   ----   --------------------------------------------
  124.          2.8       5/91   Added mouse support to Scrolling Bar Menus.
  125.                           Eliminated "color" parameter in Bar menus --
  126.                           Sparkle now reverses whatever colors are there.
  127.  
  128.          2.7      11/90   Added "Phone ringing" sound effect and "Pause."
  129.                             "   "Monitor detect" option.
  130.                             "   "Register.Exe" to shareware versions.
  131.  
  132.          2.4-2.6   9/90   Improved the "Window" option so you now have
  133.                           250+ frame styles!
  134.                           Fixed bug: ASK didn't return 27 if Esc pressed.
  135.  
  136.          2.3       6/90   1st public release.
  137.  
  138.  
  139.                              WARRANTY & DISCLAIMER
  140.          ==============================================================
  141.  
  142.          This product is provided "AS IS" without warranty of any kind.
  143.          The entire risk as to the results and performance of this pro-
  144.          duct is assumed by you.  We warrant only that any disks we sent
  145.          you are free from physical and workmanship defects under normal
  146.          use and service for a period of 90 days from the date shipped.
  147.  
  148.          Our entire liability, and your exclusive remedy, as to the disk,
  149.          shall be to, at our option, either (1) return the purchase price;
  150.          or, (2) replace disks which don't meet our limited warranty.
  151.           * Since you can try "user supported" versions of our programs
  152.             before ordering them, we offer no other warranty beyond that
  153.             stated here.  We'll gladly replace defective disks.  But no
  154.             refunds or credits can be issued.
  155.  
  156.          Neither Pro~Formance nor RWS & Associates nor Rob W. Smetana,
  157.          nor any of their officers or employees shall be held respon-
  158.          sible for:  failures of this product to satisfy any needs,
  159.          damages due to using this product, or any effects this program
  160.          has on you, your business or operations.
  161.  
  162.          This product, its manual and any supporting materials may be
  163.          modified or changed from time to time.  They may contain opera-
  164.          tional inaccuracies or typographical errors which may be cor-
  165.          rected by future versions, if any.  Registered users may be
  166.          notified of available updates.
  167.  
  168.  
  169.                                                                            
  170.  
  171.                                 LIMITED LICENSE
  172.          =============================================================
  173.  
  174.  
  175.          *** See the next page for details on INSTANT registration. ***
  176.  
  177.  
  178.          Sparkle is NOT public domain or free software.  It is distrib-
  179.          uted as "user-supported" software or "shareware."
  180.  
  181.          If you decide to use Sparkle beyond the trial period, we ask
  182.          for a modest contribution to help us add other useful options.
  183.          You'll find a registration form at the end of this manual.
  184.  
  185.  
  186.          Non-registered users of this software are granted a limited
  187.          license to "try out" the user-supported version, on a private,
  188.          non-commercial basis, for the express purpose of determining
  189.          whether it suits your needs.  At the end of this trial period,
  190.          you must either register your copy or stop using it.
  191.  
  192.          * Running Sparkle 15-20 different times should allow you
  193.            to decide if it's going to be useful to you.  Therefore
  194.            the "trial period" is set at 20 Sparkle sessions.
  195.  
  196.          ==============================================================
  197.  
  198.            WARNING:  You MAY NOT use this program in any organization
  199.            or in the conduct of any business activity without a prior
  200.            purchase or license arrangement.
  201.  
  202.            Sparkle MAY NOT be distributed with any other product or
  203.            service without a prior license arrangement.
  204.  
  205.          ==============================================================
  206.  
  207.          What does all this really mean?  It's really very simple.  Try
  208.          it.  Then either pay for it, or stop using it.
  209.  
  210.           * If you use this program, then you should pay for your copy.
  211.             Sparkle is NOT free, and we're not giving away free copies.
  212.             We are giving you the chance to try it before you buy it.
  213.  
  214.           * Paying for this software allows us to stay in business and
  215.             provide you with support, enhancements and updates.
  216.  
  217.  
  218.             The next page explains the 2 ways you have to register.
  219.  
  220.                                                                           
  221.  
  222.  
  223.                              Registering INSTANTLY
  224.          ==============================================================
  225.  
  226.          You can register for Sparkle in two ways:  By mail (see the
  227.          registration form at the end of this manual), or INSTANTLY by
  228.          phone (with a Visa or MasterCard number).  You can also elect
  229.          to have the latest version of Sparkle sent to you.
  230.  
  231.          Shareware versions of Sparkle should include REGISTER.Exe.
  232.          Run this program to convert shareware versions into fully
  233.          registered versions.  Here's how.
  234.  
  235.  
  236.              SHAREWARE VERSIONS OF Sparkle ARE FULLY FUNCTIONING.
  237.  
  238.          They have ALL the features of registered versions, with NO
  239.          limitations.
  240.  
  241.          However, shareware versions will periodically remind you to
  242.          register.  Sparkle will pause with this message displayed at
  243.          the bottom of your screen:
  244.  
  245.           Reminder:  This is an unregistered version.  Run REGISTER.Exe
  246.  
  247.          This reminder disappears when you run REGISTER (or receive a
  248.          registered version from us).
  249.  
  250.                   To Register Instantly Using REGISTER.Exe . . .
  251.                   ==============================================
  252.  
  253.          Step 1:  Be sure that both Sparkle.Exe and REGISTER.Exe are on
  254.                   the drive/directory you're logged onto (Sparkle.Exe
  255.                   MUST be).
  256.  
  257.          Step 2:  You'll call us twice at (415) 863 - 0530.
  258.                   * The first time you call, give us your name, address
  259.                     and Visa or MasterCard number.
  260.                   * We'll verify the credit card information and add your
  261.                     name to our database so we can notify you about updates.
  262.  
  263.          Step 3:  BEFORE you call us the 2nd time:
  264.                   * Be sure Sparkle.Exe is on the current drive/directory.
  265.  
  266.                   * Now run REGISTER.Exe.  REGISTER will ask for the
  267.                     name of the program you want to register.  Type in
  268.                     "sparkle" (without the quotation marks and without .EXE).
  269.  
  270.                   * REGISTER will then print a number.
  271.                     - CALL US when that number is on your screen and
  272.                       tell us what the number is.
  273.                     - We'll give you a different number to type in.
  274.  
  275.                   * REGISTER will then ask you to enter your name.  Type in
  276.                     your name and you'll have a fully-registered version.
  277.  
  278.                                                                            
  279.  
  280.                              DISTRIBUTING  Sparkle
  281.          =============================================================
  282.  
  283.          Bulletin board Sysops, clubs and shareware distributors may
  284.          copy and distribute SHAREWARE versions of Sparkle, provided:
  285.  
  286.          *** Your company name IS NOT:   California Freeware         ***
  287.                                            American Freeware
  288.                                                  US Freeware
  289.              (or any other firm, group or association with "Freeware"
  290.              in its name, literature, adds, etc.), which companies are
  291.              PROHIBITED from distributing ANY products by Rob W. Smetana,
  292.              Pro~Formance, RWS & Associates or their officers, staff or
  293.              associates.
  294.  
  295.          *** Your company or group DOES NOT include among its staff, ***
  296.              officers, associates, consultants, members, or directors
  297.              RONALD CHORDIGIAN, members of his family or his assigns.
  298.  
  299.          *** Your adds, literature and company name DO NOT include:   ***
  300.              "free software," "freeware," "free" or other such
  301.              terms which misrepresent "user-supported" software.
  302.  
  303.          (1) It is distributed in completely unmodified form.
  304.  
  305.          (2) You charge nothing other than a "disk distribution fee"
  306.              of up to $8.00 to cover distribution and handling.
  307.  
  308.          (3) You state YOUR fee is NOT payment or registration for
  309.              OUR software.
  310.  
  311.          (4) You clearly encourage registration by stating that con-
  312.              tinued use justifies sending contributions to the developer.
  313.  
  314.          (5) You include all these files intact:
  315.  
  316.              Sparkle.Exe, Sparkle.Doc, SP-Demo.Bat, V-Menu.Com, H-Menu.Com
  317.  
  318.  
  319.  
  320.                                                                             
  321.  
  322.                         General Notes:  Using Sparkle
  323.       =================================================================
  324.  
  325.       For a list of options and explanations, enter:  Sparkle  <Enter>
  326.       Here's what Sparkle will display:
  327.  
  328.            Sounds  Sparkle  1  #   (# = 1 to 35, 88 or 99)
  329.          Bar Menu  Sparkle  2  TopRow LftCol BotRow RhtCol Direction
  330.               Ask  Sparkle  3  Row Column Color /ValidKeys /Text
  331.         Big! Font  Sparkle  4  Row Column Color CharacterCode /Text
  332.         QuikPrint  Sparkle  5  Row Column Color /Text
  333.            Window  Sparkle  6  TopRow LftCol BotRow RhtCol Color Frame /Text
  334.             Pause  Sparkle  7  HowLong (optional:  99 = allow interrupt)
  335.           Monitor  Sparkle  8  (optional: 99; Errorlevel = 1 if mono monitor)
  336.  
  337.       Experiment
  338.       ==========
  339.       Sparkle is fun!  Experiment with different options, sounds and colors.
  340.  
  341.  
  342.       Choosing Options
  343.       ================
  344.       Each option has a number.  And each option also has sub-options
  345.       (or instructions) you must send Sparkle.  In general, run Sparkle
  346.       like this:    Sparkle Option# x1 x2 x3 x4 ..... <enter>
  347.  
  348.            Where:   Option# is a number from 1 - 8 (1=Sound, 2=Menu, etc.)
  349.  
  350.                     x1, x2 ... etc. are sub-options or instructions
  351.  
  352.           Notice:   * A space MUST separate each item on the command line.
  353.                     * Where we need numbers, send us only numbers (not A-Z).
  354.                     * Whenever you send us text, you MUST begin it with
  355.                       "/" -- see the examples below.
  356.  
  357.            Color:   Several options require a Color -- a number from 1-254
  358.                     telling us which foreground AND background color to use.
  359.                     See "Calculating Color" for tips on choosing colors.
  360.  
  361.       Errorlevel:   Some options return a DOS Errorlevel.  See "Testing
  362.                     Errorlevels" and the description of each option.
  363.  
  364.       Examples:
  365.       =========
  366.       Sound         Sparkle 1 14
  367.  
  368.                     1 = Option #1 Sound Effects.  14 = the 14th sound.
  369.  
  370.       Big! Font     Sparkle 4 1 1 112 219 /Big! Font
  371.  
  372.                     4 = print a Big! Font message.  Other items tell us
  373.                     where to print it, what color to use, which character
  374.                     to "construct" your message with, and what to print.
  375.  
  376.       Ask           Sparkle 3 25 35 15 /123 /Press 1, 2 or 3
  377.  
  378.                     3 = Ask (print a message or prompt and wait for a
  379.                     key).  Other instructions tell us where to print it,
  380.                     what color to use, and what message to print.
  381.                                                                            
  382.  
  383.  
  384.                            Option 1:   SOUND EFFECTS
  385.       =================================================================
  386.  
  387.       To use:   Sparkle  1  #   (# = 1 to 35, 88 or 99)
  388.  
  389.       Purpose:  To give you over 35 simple to complex sound effects.
  390.                 Number 88 = a ringing phone
  391.                 Number 99 = part of the William Tell Overture
  392.  
  393.       Example:
  394.  
  395.          Sparkle 1  99
  396.                  ^  ^
  397.                  |  }"99" means play part of the William Tell Overture
  398.                  |
  399.                  }option 1 (Sound Effects)
  400.  
  401.           Replace "99" with 88 or a number from 1 to 35 indicating which
  402.           sound you want.  Numbers 6 through 14 offer compound sounds --
  403.           trills, "Oh Oh," etc.  Other numbers are simple tones of
  404.           various durations.
  405.  
  406.  
  407.       NOTE:  Sparkle checks to see what type of CPU is being used.  It
  408.              does this to ensure sounds are comparable regardless of
  409.              whether an 8088, 286, 386 or 486 PC is used.  In other
  410.              words, the sounds should be similar regardless of how fast
  411.              the PC is.  But speakers will affect sounds.
  412.  
  413.                                                                            
  414.  
  415.                         Option 2:  SCROLLING BAR MENUS
  416.       =================================================================
  417.  
  418.       To use:   Sparkle  2  TopRow LeftCol BotRow RightCol Direction
  419.  
  420.       Purpose:  To turn ANY text (not graphics) screen into a Vertical
  421.                 or Horizontal scrolling bar menu.  Here's what you do:
  422.  
  423.       1. Display a screen.  You use Sparkle's Window and QuikPrint
  424.          options to create a menu.  You can "echo" text in a batch file.
  425.          Or "run" a P-Screen "Com" screen and blast your screen up.
  426.          
  427.  
  428.       2. Run Sparkle like this:
  429.  
  430.              Sparkle 2 TopRow LftCol BotRow RhtCol Direction
  431.  
  432.          Where:
  433.              - "2" = Option 2 (the menu option)
  434.  
  435.              - TopRow, LeftCol, BotRow, RightCol indicate the location of
  436.                your menu on the screen (tell us where menu options are).
  437.  
  438.              - Direction = 1 (vertical menu) or 2 (horizontal menu)
  439.  
  440.              NOTE:  To determine TopRow, LeftCol, BotRow and RightCol:
  441.                     1) Run "Ruler.Exe" -- our RAM-resident ruler.
  442.                        With your menu screen visible, call up Ruler.
  443.                        Move the cursor to the top left corner of your
  444.                        menu; note the Row/Column.  Now move to the
  445.                        bottom, right corner.  Note the Row/Column.
  446.  
  447.                     2) Manually count rows and columns.
  448.  
  449.       3. Test Errorlevel.   (See "A Note About Testing Errorlevels")
  450.  
  451.          Sparkle returns a DOS Errorlevel indicating which option was
  452.          selected.  Interpret the Errorlevel like this:
  453.  
  454.          1 to x    = The number of the option chosen (1 = the 1st option,
  455.                      2 = 2nd option..... x = last option)
  456.           27       = Esc was pressed
  457.           88 or 99 = Either your screen location variables were "wrong"
  458.                      (eg., Top Row <<greater than>> Bottom Row).
  459.  
  460.                      Or we found no TEXT / Menu Choices in the area
  461.                      of the screen where you said your menu would be.
  462.  
  463.                                                                              
  464.  
  465.      Scrolling Bar Menus (continued)
  466.      ==================================================================
  467.  
  468.      Example:
  469.  
  470.          Sparkle 2  5 45  20 78  1
  471.                  ^  ^ /   ^ /    ^
  472.                  |  |/    |/     }It's a Vertical menu (choices up/down)
  473.                  |  |     |
  474.                  |  |     |
  475.                  |  |     |
  476.                  |  |     }menu ends on row 20, column 78
  477.                  |  |
  478.                  |  }menu starts on row 5, column 45
  479.                  |
  480.                  }option 2 (Menu)
  481.  
  482.  
  483.       IMPORTANT NOTES on Creating Menu Screens: : : :
  484.       ===============================================
  485.  
  486.        1.  Once you define the "coordinates" of a menu screen, we scan
  487.            the screen looking for "menu text."  We ignore blank lines
  488.            and lines with only "graphics" (lines, boxes or shading).
  489.  
  490.            - ANY text found inside the screen coordinates WILL be
  491.              considered menu text -- UNLESS you begin that line of text
  492.              with Chr$(255) (ASCII character #255).  Use 255 to tell
  493.              us to ignore lines inside your window that explain what
  494.              the user should do, that introduce something, etc.
  495.  
  496.              You can enter character 255 in two ways:
  497.  
  498.              a) Create your screen with our P-Screen program.  Move the
  499.                 cursor to the beginning of each line of text you want us
  500.                 to ignore.  Press Alt-J to display the "Join" window.
  501.                 Move the cursor to the last character in the window
  502.                 (it'll look blank).  Press <Enter> to accept it.
  503.  
  504.              b) Most word processors or editors let you enter "High
  505.                 ASCII" characters.  Load your menu screen into your word
  506.                 processor.  Move the cursor to the beginning of each
  507.                 line of text you want us to ignore.  Hold down the Alt
  508.                 key and enter 255 on the NUMERIC KEYPAD of your keyboard
  509.                 (DON'T use the numbers at the top of your keyboard.
  510.  
  511.              Character 255 is NUL or Blank.  It looks just like a blank
  512.              space on your screen.  In P-Screen you can "paint" it any
  513.              color you want, or you can move, copy or delete it.
  514.  
  515.        2.  In Horizontal menus, also use character 255 to "link" 2 or
  516.            more words that are part of the same menu option.  For Example:
  517.  
  518.                   Lotus 123    Paradox    WordPerfect   Quit
  519.  
  520.            - This menu has 4 options.  But notice the space between
  521.              "Lotus" and "123".  If we don't plug that space with char-
  522.              acter 255 (or a hyphen), Sparkle WILL treat "123" as a menu
  523.              option -- giving us 5 not 4 options.                        
  524.                                                                             
  525.  
  526.       Important Notes on Scrolling Bar Menus (continued)
  527.       =================================================================
  528.  
  529.        3.  In VERTICAL menus, each line should be a single menu choice.
  530.  
  531.             * Each line can have as many words on it as you like (and
  532.               you needn't fill blanks between words with character 255).
  533.  
  534.             * If you need to create menu options with 2 or more lines,
  535.               start the 2nd, 3rd, etc. line with character 255 -- so
  536.               Sparkle ignores them.
  537.  
  538.        4.  In HORIZONTAL menus, ALL menu options must be on a single
  539.            line.  And the first line of text we find that doesn't begin
  540.            with character 255 will be treated as your menu line.  NOTE:
  541.            normally TopRow and BotRow will be the same for horizontal menus.
  542.  
  543.        5.  Sparkle highlights menu choices by REVERSING the colors --
  544.            the background color becomes the foreground; the foreground
  545.            color becomes the background.
  546.  
  547.            You may find that simple, high-contrast colors (white on
  548.            black, white on blue, black on red) reverse best.  You may
  549.            also find that normal colors (not bright colors) reverse best.
  550.  
  551.            And, depending on what numbers you send Sparkle in TopRow,
  552.            LeftCol, BotRow and RightCol, you can create some interesting
  553.            multi-color effects.  For example:
  554.  
  555.             * Suppose you created a White on Red window from the left
  556.               to right sides of your screen (column 1 to column 80).
  557.               You then printed your menu options in white on black
  558.               on rows 5 to 15 and from column 30 to 50.
  559.               - If you tell Sparkle your menu is in columns 25 to 55,
  560.                 it'll reverse a little of the red on each side of the
  561.                 text, then reverse the text -- showing text in black on
  562.                 white.
  563.  
  564.             * If some words or characters in a menu item are in colors
  565.               different than the rest, they'll be reversed to a different
  566.               color than the rest.
  567.  
  568.            To ensure the highlight is visible, BE SURE to use high-contrast
  569.            colors for the foreground and background of menu text.  If you
  570.            don't, the menu highlight will be hard or impossible to see.
  571.  
  572.        6.  To select options in bar menus using a MOUSE:
  573.  
  574.             * Click the LEFT button on an option to highlight that option.
  575.  
  576.             * DOUBLE click the LEFT button on an option to select it.
  577.  
  578.             * Sparkle uses only the left mouse button (and ignores others).
  579.                                                                            
  580.                                                                            
  581.  
  582.                                Option 3:  ASK
  583.       =================================================================
  584.  
  585.       To Use:   Sparkle  3  Row Column Color /ValidKeys /Text
  586.  
  587.       Purpose:  ASK lets you treat ANY screen as a menu screen.  Or use
  588.                 ASK just to pause until users press a key.  You can:
  589.  
  590.                 1) display a message anywhere on the screen (text mode only)
  591.                 2) display it in whatever color you want
  592.                 3) wait for the user to press one of the keys you specified,
  593.                    then report an Errorlevel indicating which key was
  594.                    pressed.  (See "A Note About Testing Errorlevels")
  595.  
  596.  
  597.        YOU specify which keys we should exit on (Sparkle also exits if
  598.        Escape is pressed).  For example, say you display a menu and ask
  599.        the user to choose an option by pressing 1, 2, 3, 4 or Q to Quit.
  600.         - Just tell us the Valid Keys are 1234Q.
  601.  
  602.         - If Valid Keys is NULL (Empty or Nothing), we'll wait until
  603.           ANY KEY is pressed, then exit with Errorlevel set to 0.
  604.  
  605.  
  606.         Example:
  607.  
  608.           Sparkle 3 25 35 112 /1234q /Please press 1, 2, 3, 4 or [Q]uit
  609.                   ^  ^ /  ^   ^      ^
  610.                   |  |/   |   |      }print the message beginning with "/"
  611.                   |  |    |   |
  612.                   |  |    |   }wait until user presses one of these keys
  613.                   |  |    |
  614.                   |  |    }print in color 112 (black on white)
  615.                   |  |
  616.                   |  }print on Row 25, Column 35
  617.                   |
  618.                   }option 3 (ASK)
  619.  
  620.       NOTES on Ask
  621.       ============
  622.  
  623.        - If ValidKeys AND Text are both blank, Sparkle prints nothing
  624.          and just waits until the user presses ANY key.
  625.  
  626.        - Sparkle sets the DOS Errorlevel to indicate which key was pressed.
  627.          -- 27 means Escape was pressed.
  628.          -- Otherwise it's the Ascii code of the key pressed:  49=1, 90=Z,
  629.             etc.
  630.          -- See "Notes on Testing Errorlevels" for examples of how to
  631.             deal with these.
  632.  
  633.        - IMPORTANT:
  634.          -- You MUST use a backslash (/) to begin BOTH your
  635.             list of valid keys AND the text to be printed.
  636.  
  637.          -- We treat user key presses in upper case (ie., we don't
  638.             distinguish a from A).  But your list of Valid Keys
  639.             can be in upper or lower case (or both).
  640.                                                                             
  641.  
  642.  
  643.         ▌▌▌▌▌▌   ▌▌▌▌  ▌▌▌▌▌   ▐▐     ╬╬╬╬╬╬╬                    ╪╪   (tm)
  644.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌  ▐▐      ╬╬   ╬                    ╪╪
  645.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌  ▐▐      ╬╬ ╬    ║║║║║   ││││││  ╪╪╪╪╪╪
  646.          ▌▌▌▌▌    ▌▌  ▌▌       ▐▐      ╬╬╬╬   ║║   ║║  ││   ││   ╪╪
  647.          ▌▌  ▌▌   ▌▌  ▌▌ ▌▌▌▌  ▐▐      ╬╬ ╬   ║║   ║║  ││   ││   ╪╪
  648.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌          ╬╬     ║║   ║║  ││   ││   ╪╪
  649.         ▌▌▌▌▌▌   ▌▌▌▌  ▌▌▌▌▌   ▐▐     ╬╬╬╬     ║║║║║   ││   ││   ╪╪╪╪
  650.  
  651.       ==================================================================
  652.  
  653.       To Use:   Sparkle  4  Row Column Color CharacterCode /Text
  654.  
  655.       Purpose:  Big! Font, turns your message into one 7-8 lines high.
  656.                 Each character will be 8 columns wide.  You can:
  657.  
  658.                 - display a Big! Font message anywhere on the screen
  659.                 - display it in whatever color you want
  660.                 - "build" your message using ANY ASCII character
  661.  
  662.       (If you printed this and your printer can't print the high ASCII
  663.       characters, the Big! Font message is probably a mess.  Sorry.  But
  664.       if you're browsing through this on your PC, you can see how drama-
  665.       tic Big! Font messages can be.  And Sparkle gives you color as well.)
  666.  
  667.  
  668.       Example:
  669.  
  670.             Sparkle 4  9  1 12  219 /Hi There !
  671.                     ^  ^ /  ^   ^      ^
  672.                     |  |/   |   |      }print the message beginning with "/"
  673.                     |  |    |   |
  674.                     |  |    |   }"Build" characters using ASCII character 219
  675.                     |  |    |
  676.                     |  |    }print in color 12 (Bright Red on Black)
  677.                     |  |
  678.                     |  }begin printing on Row 9, Column 1
  679.                     |
  680.                     }option 4 (Big! Font)
  681.  
  682.  
  683.       NOTES on Big! Font
  684.       ==================
  685.        * Since each character will be 8 columns wide, only 10 Big! Font
  686.          characters will fit on 80-column screens.
  687.  
  688.        * "Row" is the TOP row on which to begin printing.  Most Big!
  689.          Font characters will have 7 lines.  But characters with descen-
  690.          ders (such as lower case g, y, q, p, etc.) also need the 8th line.
  691.          - Be sure to specify a Row at least 7 lines above the bottom of
  692.            your screen -- or you won't see the bottom of the characters.
  693.          - Sparkle WILL print on 43 or 50 line screens.
  694.  
  695.        * We'll "build" characters using any ASCII character you specify.
  696.          If you specify "0" we'll build each character using THAT char-
  697.          acter (ie., we'll build a "G" with Gs, an "X" with Xs, etc.).
  698.          - Use 219 - 223 for bold, solid or "striped" characters.
  699.          - Use 1 or 2 for "happy faces," 176 - 178 for shaded characters.
  700.          - ANY ASCII character from 1 to 254 will work.                    
  701.  
  702.  
  703.  
  704.  
  705.                             Option 5:  QUIKPRINT
  706.       =================================================================
  707.  
  708.        To use:   Sparkle  5  Row Column Color /Text
  709.  
  710.        Purpose:  Quickly print text anywhere on your screen in any color.
  711.                  You can print ANY Ascii character from 1-255 -- you're
  712.                  not limited to printing normal keyboard characters.
  713.  
  714.        Example:
  715.  
  716.             Sparkle 5  25 25  112  /Good Morning
  717.                     ^   ^ /   ^    ^
  718.                     |   |/    |    }print the message beginning with "/"
  719.                     |   |     |
  720.                     |   |     }print in color 112 (black on white)
  721.                     |   |
  722.                     |   }begin printing on Row 25, Column 25
  723.                     |
  724.                     }option 5 (QuikPrint)
  725.  
  726.  
  727.                                                                              
  728.  
  729.                              Option 6:  WINDOWS
  730.       =================================================================
  731.  
  732.        To Use:   Sparkle  6  TopRow LftCol BotRow RhtCol Color Frame /Text
  733.       
  734.        Purpose:  Quickly create windows (or boxes) on the screen.
  735.                  - Choose from over 250 frame styles!!!
  736.                  - Windows can have shadows (or not)
  737.                  - Use any color
  738.                  - You can include text or a title, centered on the top row
  739.  
  740.  
  741.        Frame     Sparkle offers over 250 frame styles, which you select
  742.        styles:   by setting Frame = 1 to 255.   Styles 1-5 include:
  743.  
  744.                    1 = Single line all around                        (┌)
  745.                    2 = Double line all around                        (╔)
  746.                    3 = Double line horizontal, single line vertical  (╒)
  747.                    4 = Double line vertical, single line horizontal  (╓)
  748.                    5 = Bolder solid line                             (▐▀)
  749.                    6 = DON'T use.  This is meant only for multiple
  750.                        colors which Sparkle presently can't handle.
  751.  
  752.                  If you set Frame to any OTHER number from 7-255, Sparkle
  753.                  draws your window in that ASCII character.  For example,
  754.  
  755.                    219 = Bold solid line                             (█)
  756.                      7, 249 or 250 = dots of various sizes  (can't show here)
  757.                     61 = The equal sign "="
  758.                     86 = The letter "V"
  759.                     etc.... you get the idea.  Experiment!
  760.  
  761.  
  762.        Titles:   Sparkle prints "/Text" (your title or message) centered
  763.                  on the top row of your window.
  764.  
  765.  
  766.        Shadow:   To request a "drop shadow" for your window, send Sparkle
  767.                  a NEGATIVE frame number (eg., -2).
  768.                  - Shadows are printed right of and below your window.
  769.                  - Be sure to allow for TWO extra columns on the right,
  770.                    and ONE extra row on the bottom of shadowed windows.
  771.  
  772.  
  773.        Frameless  NOTE:  ASCII characters 32 and 255 are blank.  If you
  774.        Windows:   create "windows" with these, you'll get a frameless
  775.                   splash of color!  Specify Frame = -32 or -255 to get
  776.                   a shadowed splash of color!
  777.  
  778.  
  779.        Example:
  780.  
  781.             Sparkle 6  5  7 20  75  79 -1  /My Window
  782.                     ^  ^  /  ^  /   ^   ^  ^
  783.                     |  | /   | /    |   |  }Print this title/message
  784.                     |  |/    |/     |   }Frame style 1 AND shadowed (negative)
  785.                     |  |     |      }Use color 79 (White on Red)
  786.                     |  |     }Window ends on row 20, column 75 (shadow below)
  787.                     |  }Window starts on row 5, column 7 (shadow on right)
  788.                     }option 6 (Window)
  789.                                                                            
  790.  
  791.  
  792.                              Option 7:  PAUSE
  793.       =================================================================
  794.  
  795.        To Use:   Sparkle  7  HowLong  Interrupt (optional)
  796.  
  797.        Purpose:  Allow batch files to pause briefly, and then continue.
  798.                   - You can specify pauses from 1/3 second to several
  799.                     minutes.
  800.                   - You can also allow users to "interrupt" or bypass
  801.                     the pause and go on (optional).
  802.  
  803.        Examples:
  804.  
  805.             Sparkle 7  12
  806.                     ^  ^
  807.                     |  |
  808.                     |  }Pause for 4 seconds (each # = 1/3 second)
  809.                     |
  810.                     }option 7 (Pause)
  811.  
  812.  
  813.             Sparkle 7  15  99
  814.                     ^  ^   ^
  815.                     |  |   |
  816.                     |  |   }Pause, but let user "press a key" to go on
  817.                     |  |
  818.                     |  }Pause for 5 seconds (each # = 1/3 second)
  819.                     |
  820.                     }option 7 (Pause)
  821.  
  822.  
  823.       NOTES on Pause
  824.       ==============
  825.  
  826.        * "HowLong" is measured in 1/3 second increments.  "12" tells
  827.          Sparkle to pause 4 seconds (12/3 = 4).  Similarly, "15" means
  828.          pause 5 seconds (15/3 = 5).
  829.          - An easy way to decide what number to use is to decide how
  830.            many SECONDS you want to pause, then MULTIPLY that by 3.
  831.  
  832.        * To let users "press a key" to interrupt the pause and move on,
  833.          send Sparkle 2 numbers:  HowLong AND 99.   For example:
  834.  
  835.             Sparkle 7 6 99.
  836.  
  837.        * Sparkle checks to see what type of CPU is being used -- to
  838.          ensure pauses are the same regardless of whether an 8088, 286
  839.          386 or 486 PC is used.
  840.          - HOWEVER, the speed of the disk drive WILL affect the pause.
  841.            That's because Sparkle must load first, and then pause.
  842.          - Although Sparkle is small and loads quickly, floppy disks can
  843.            be 10-15 times SLOWER than hard disks.  If your batch files
  844.            will run off of different types of disks, test them on
  845.            different disk drives to determine the length of a pause
  846.            that's a "happy medium" on all drives.
  847.  
  848.                                                                             
  849.  
  850.                              Option 8:  MONITOR
  851.       =================================================================
  852.  
  853.        To Use:   Sparkle  8  (optional 99; Errorlevel = 1 if mono monitor)
  854.  
  855.        Purpose:  Report what type of display adapter AND monitor is active.
  856.                  - This is handy to decide which colors to use in batch files.
  857.                  - This is also handy to start presentations using our
  858.                    P~F Presents program.  Run presentations in Color or
  859.                    in "monochrome" based on the type of monitor being used.
  860.  
  861.        Example:
  862.  
  863.             Sparkle 8
  864.                     ^
  865.                     |
  866.                     }option 8 (Monitor)
  867.  
  868.             Sparkle 8  99
  869.                     ^  ^
  870.                     |  |
  871.                     |  }Set Errorlevel=1 if a monochrome monitor is detected
  872.                     |   (regardless of the type of display adapter present)
  873.                     |
  874.                     }option 8 (Monitor)
  875.  
  876.  
  877.       NOTES on Monitor
  878.       ================
  879.  
  880.        * Option 8 tells Sparkle to set the DOS Errorlevel based on BOTH
  881.          the type of display adapter AND monitor detected.
  882.  
  883.          Run Sparkle with NO options (ie., Sparkle 8), and it sets the
  884.          Errorlevel as follows:
  885.  
  886.             1 = Monochrome adapter            2 = Hercules adapter
  887.             3 = CGA adapter
  888.             4 = EGA adapter/Mono monitor      5 = EGA adapter/Color monitor
  889.             6 = VGA adapter/Mono monitor      7 = VGA adapter/Color monitor
  890.             8 = MCGA adapter/Mono monitor     9 = MCGA adapter/Color monitor
  891.            10 = EGA adapter/CGA monitor      11 = IBM 8514/A adapter
  892.  
  893.        * NOTE that options 1, 4, 6 and 8 ALL indicate a monochrome
  894.          monitor is active.  If all you need to know is whether the
  895.          monitor is Color or Mono, run Sparkle like this:   Sparkle 8  99
  896.  
  897.           - "99" tells Sparkle to set the Errorlevel to 1 if a mono monitor
  898.             is detected (ie., if Sparkle would normally report 1, 4, 6 or 8).
  899.  
  900.           - This can simplify testing Errorlevels to something like:
  901.  
  902.               If Errorlevel 3 goto ItsColor   'If greater than or equal to 3..
  903.               Goto ItsMonochrome              'Otherwise, assume it's mono.
  904.  
  905.        SEE THE NEXT PAGE for examples of how you can use Option 8 to set
  906.        options "on the fly" in batch files.
  907.                                                                             
  908.  
  909.        Option 8 MONITOR  (continued)
  910.  
  911.  
  912.        Two DOS features ("named parameters" and SET) can help you
  913.        customize your batch files -- depending on the type of monitor
  914.        Sparkle tells you is active.  (These features may not be
  915.        available with all DOS versions.)
  916.  
  917.        "Named parameters" let you define "variables" you can use later
  918.        in your batch files.  Basically, you:
  919.  
  920.         * Use the DOS SET command to set variable(s) to specific values
  921.           (eg., SET ErrSound=12, or SET MyColor=15, or SET HiLite=112).
  922.  
  923.         * Run Sparkle and use variable NAMES rather than values
  924.           (eg., Sparkle 1 ErrSound).
  925.  
  926.  
  927.        Here's an example.  Notice how we:
  928.  
  929.          1.  Run Sparkle to see if a color monitor is being used.
  930.  
  931.          2.  Depending on the type of monitor detected (color or mono),
  932.              we SET a variable called "WhichClr" to a color appropriate
  933.              for that monitor.
  934.              -- "WhichClr" will now be available to every other line in
  935.                 our batch file -- as long as we use the variable name.
  936.  
  937.          3.  We then use the variable NAME to tell Sparkle which color
  938.              to print with.
  939.              -- NOTICE that when we use the variable when running
  940.                 Sparkle, we place it between two percent signs (eg.,
  941.                 %WhichClr%).  This is REQUIRED!
  942.  
  943.  
  944.             sparkle 8 99                       '"99" since we only need to
  945.                                                'know if it's color or mono
  946.  
  947.             If Errorlevel 3 goto _PrtInColor   'if 3 or higher, it's color
  948.  
  949.             Set WhichClr=112                   'If 1 or 2, it's a
  950.                                                'monochrome monitor; use
  951.                                                'simple Black on White.
  952.  
  953.             Sparkle 5 21 15 %WhichClr% / MONOCHROME monitor detected
  954.  
  955.             goto (somewhere to jump over the Color section)
  956.  
  957.             :_PrtInColor
  958.  
  959.             Set WhichClr=78                     'It's color, SET "WhichClr"
  960.                                                 'to 78  (Yellow on Red).
  961.  
  962.             Sparkle 5 21 15 %WhichClr% / COLOR monitor detected
  963.  
  964.                                                                            
  965.  
  966.                         A NOTE ON TESTING Errorlevels
  967.       =================================================================
  968.  
  969.       Always test Errorlevels from the HIGHEST number to the LOWEST (this
  970.       is a DOS restriction).  For example:
  971.  
  972.              If Errorlevel 2 goto no         \   this sequence
  973.              If Errorlevel 1 goto yes        /   is correct
  974.  
  975.              If Errorlevel 1 goto yes        \   this sequence
  976.              If Errorlevel 2 goto no         /   is WRONG
  977.  
  978.  
  979.       Here's why this is important.  DOS tests the phrase:
  980.  
  981.                     If Errorlevel 1 goto yes
  982.  
  983.       as if it read "If Errorlevel greater-than-or-equal-to 1 goto Yes."
  984.  
  985.       So, if you start testing with "If Errorlevel 1 goto Yes" (note
  986.       "1"), DOS will almost ALWAYS go to "Yes" -- since most everything
  987.       is "greater-than-or-equal-to 1".
  988.  
  989.  
  990.       Examples:
  991.       =========
  992.  
  993.       Here's an example from Sparkle's demo batch file (SP-Demo.Bat).
  994.       We first display a bar menu.  We then test to see which option was
  995.       chosen.  Note that we first test for Escape (Ascii code 27).  Bar
  996.       menus return the NUMBER of the option chosen.  Our main menu had 5
  997.       choices.  We first test for Escape, since 27 is higher than 5.  We
  998.       then test for which option was chosen with "If Errorlevel 5 ...."
  999.  
  1000.           :_MainMenu
  1001.           Sparkle  2  5 5 5 76 112 2
  1002.           If Errorlevel 27 goto _End
  1003.           If Errorlevel 5  goto _End
  1004.           If Errorlevel 4  goto _BarMenus
  1005.           If Errorlevel 3  goto _Sounds
  1006.           If Errorlevel 2  goto _Windows
  1007.           If Errorlevel 1  goto _Intro
  1008.           goto _MainMenu                   (just in case tests fail)
  1009.  
  1010.       Here's what a batch file might look like if you used ASK.
  1011.  
  1012.         * NOTE:  Here we test for Escape LAST!!  That's because ASK
  1013.           returns the ASCII value of the key pressed.  The ASCII code
  1014.           for "Y" is 89, the code for "N" is 78.  The code for Escape
  1015.           (27) is LESS than 89 or 78, so we test for it last.
  1016.  
  1017.           :_AskAgain
  1018.           Sparkle 3 25 20 112 /YN /Do you want to go on?  Press [Y]es or [N]o
  1019.           If Errorlevel 89 goto _YesPressed
  1020.           If Errorlevel 78 goto _NoPressed
  1021.           If Errorlevel 27 goto _AskAgain     '--- We'll ONLY accept Y or N!
  1022.  
  1023.  
  1024.                                                                            
  1025.  
  1026.                             CALCULATING COLOR
  1027.       ================================================================
  1028.  
  1029.       When we ask you for a color, send us 1 number indicating BOTH
  1030.       Foreground AND Background colors.  Here's how to calculate it:
  1031.  
  1032.  
  1033.       Step 1.  Choose a BACKGROUND color from this table (they rise by 16):
  1034.  
  1035.                Black  Blue  Green  Cyan  Red  Magenta  Yellow  White
  1036.                =====================================================
  1037.                  0     16     32    48    64     80       96    112
  1038.  
  1039.  
  1040.  
  1041.       Step 2.  Now choose a FOREGROUND color from this table:
  1042.  
  1043.                 Black  Blue  Green  Cyan  Red  Magenta  Yellow  White
  1044.                 =====================================================
  1045.       Normal      0     1      2     3     4      5        6      7
  1046.  
  1047.       Bright      8     9     10    11    12     13       14     15
  1048.  
  1049.  
  1050.  
  1051.       Step 3.  Now just add them together.  For BLINKING colors, add 128
  1052.                to the number you calculate.
  1053.  
  1054.  
  1055.       Examples:
  1056.       =========
  1057.  
  1058.       Any color on Black background:        1 - 15     (Background is 0)
  1059.  
  1060.       White background with Black:           112       (112 + 0  = 112)
  1061.  
  1062.       Blue background with Bright White:      31       (16 +  15 =  31)
  1063.  
  1064.       Red background with Black:              64       (64 +  0  =  64)
  1065.  
  1066.       Cyan background with Blinking Black:   176   (48 + 0 + 128 = 176)
  1067.  
  1068.                                                                            
  1069.                            Other Programs by Pro~Formance
  1070.  
  1071.          Here's a summary of many of our programs. Call/write for details.
  1072.  
  1073.          ==================================================================
  1074.          Professional Scribe (Pro~Scribe)                  PS Express (PSE)
  1075.          ==================================================================
  1076.  
  1077.          Pro~Scribe and PSE are "writing analysts" that help you improve
  1078.          anything you write (or help you improve the writing of others --
  1079.          your staff, students, etc.)
  1080.  
  1081.          Pro~Scribe/PSE are used in companies like IBM, Hewlett Packard,
  1082.          Lockheed, Citibank, Mobil Oil, Bank of America to help improve
  1083.          memos, letters, manuals, documentation, contracts, promotional
  1084.          material, etc.
  1085.  
  1086.          How do they help?
  1087.           * They examine your writing for many types of writing mistakes.
  1088.           * You can look at overall results for an entire letter, report,
  1089.             etc.  Or, if you like, they'll look at your writing line-by-line.
  1090.           * They show suspect problems, and offer suggestions.
  1091.           * Results are shown numerically, and with several colorful graphs.
  1092.           * They come with two manuals (in addition to a Quick Ref. Guide)
  1093.             - One covers basics: To install/run PS, and basic guidelines.
  1094.             - "Effective, High-Impact Writing" has more writing tips.
  1095.           * They're colorful, fast, fun, and a terrific value:  $39 for both!
  1096.  
  1097.          How are Pro~Scribe and PSE different?   First, PS Express is a
  1098.          RAM-resident program.  That means it's always ready to help
  1099.          when you need help most -- while you're actually writing.  Run
  1100.          PSE, then run your word processor and start writing.  When you
  1101.          need help, just press a key and PSE pops up.
  1102.           * Just mark the text you want PSE to look at.  A window pops up
  1103.             instantly with feedback on your writing.
  1104.           * PSE is like having an English teacher looking over your
  1105.             shoulder, gently coaching you AS YOU WRITE!
  1106.  
  1107.          Pro~Scribe gives you everything PSE does, and much, much more.
  1108.          It reads files saved by your word processor, or you can type
  1109.          text directly into PS.  Like PSE, Pro~Scribe shows how complex
  1110.          your writing, words and sentences are.  It also offers you:
  1111.           * Feedback on "Word Wasters"  (5 categories of writing errors).
  1112.           * Three RGL (Running Grade Level) options, giving you line-by-
  1113.             line feedback.
  1114.           * An option to flag complex words and Word Wasters in each line.
  1115.           * A Personal Interest score--showing if you write as you speak.
  1116.           * Options to:  customize the program, print results on your
  1117.             printer, get help interpreting results.
  1118.  
  1119.                                                                          
  1120.          Other Programs by Pro~Formance  (continued)
  1121.  
  1122.          ==================================================================
  1123.          Mail Call  (also see P~F Form below)              MC Express (MCE)
  1124.          ==================================================================
  1125.  
  1126.          Mail Call (MC) is a full featured mailing assistant.  Add names
  1127.          to a database, then Browse through them, Search, Print, etc.
  1128.           * Print envelopes (several sizes)
  1129.           * Print mailing labels (several sizes plus a "roll-your-own-size"
  1130.             option).  1 to 99 copies of each label, 1 to 3 columns across
  1131.           * Print "personalized documents" (like "mail merge form letters")
  1132.           * Print reports, phone books, appointment schedules, etc.
  1133.  
  1134.          Mail Call offers UNlimited capacity -- use as many database files
  1135.          as you want.  And its "Mail Merge" option lets you Import or Export
  1136.          names to files used by word processors or other database programs.
  1137.  
  1138.          MC Express is a "RAM-resident" program that lets you: 1) print
  1139.          envelopes while INSIDE your word processor; and, 2) lets you
  1140.          "write out" names and addresses to a file you can later "import"
  1141.          into MC (no re-typing). (Optional; works with HP LaserJets)
  1142.  
  1143.          ==================================================================
  1144.          P~F Form (see Mail Call)      Form Design (PFD), Form Master (PFM)
  1145.          ==================================================================
  1146.  
  1147.          Form Design and Form Master are a complete form system:  design,
  1148.          math, printing, database and "auto-edit" features are all built in.
  1149.  
  1150.          Design, edit and print forms with P~F Form Design. (samples included)
  1151.           * Draw lines or boxes, or add shading, in several styles
  1152.           * Enter text, auto-centered inside boxes if you like
  1153.           * Automatically date your forms
  1154.           * Math options (+-/*) add spreadsheet convenience, speed & accuracy
  1155.           * Quick, easy block options:  Copy, Move, Erase, Shading
  1156.           * Vary fonts, type styles, line spacing
  1157.  
  1158.          Then use PFD or PFM to fill out forms.  Or let PFM do it for you!
  1159.           * "Auto-Edit" lets you quickly skip through a form, editing
  1160.             just fields you "marked."  On order forms, for example:
  1161.             Quantity, Description, Price per Unit.  Use Math for Tax & Total.
  1162.           * Use PFM to fill in other information for you -- pulling names,
  1163.             addresses, etc. from your database, putting them right where
  1164.             you want them.
  1165.  
  1166.          Produce high-quality, professional looking forms in minutes with
  1167.          Epson printers or HP LaserJets (+/500/Series II or later).  And
  1168.          you DON'T need expensive font cartridges or soft fonts for lines,
  1169.          boxes, shading, etc.  We use built-in features for these.  "But,
  1170.          I don't have a LaserJet or an Epson" you say.  Not to worry.  PF
  1171.          Form has two other printer options so it works with any printer.
  1172.  
  1173.          Finally, PFD/PFM work with the same database files as Mail Call --
  1174.          letting you manage most every piece of paper in your office.
  1175.            Forms:       Invoices, Purchase Orders, Personnel Forms, Work
  1176.                         Orders, Work Schedules, Travel or Expense Reports,
  1177.                         Accounting Forms, Application Blanks, Org. Charts
  1178.            As Well As:  Letters, Memos, Envelopes, Mailing Labels, Person-
  1179.                         alized Documents, Reports, Client or Employee lists.  
  1180.  
  1181.          Other Programs by Pro~Formance  (continued)
  1182.  
  1183.          ==================================================================
  1184.          P~F Presents                         A DESKTOP PRESENTATION System
  1185.          ==================================================================
  1186.          Use P-Screen to:       (See below for more on P-Screen)
  1187.          ................
  1188.           * Design screens (or "slides").
  1189.           * Save screens in libraries (or print them or save as Ascii files)
  1190.  
  1191.          Use PFP to:
  1192.          ...........
  1193.           * Create presentation agendas ("slide shows") which can include:
  1194.             - Menus which "branch" to various parts of your presentation,
  1195.               depending on the option your viewer selects.  For example:
  1196.               -- Which product do you want information on?
  1197.               -- Which topic (in a tutorial) do you want to review?
  1198.             - Timed slides (PFP pauses, then automatically shows the next)
  1199.             - Special effects:  animation, sound, loops, exploding windows
  1200.           * Display your presentations, or let others do it by themselves.
  1201.             A "use monochrome" option lets you display presentations on
  1202.             virtually any monitor.
  1203.  
  1204.          Possibilities:
  1205.          ..............
  1206.           * Sales presentations                * Management/Staff briefings
  1207.           * Training programs                  * Tutorials or Demos
  1208.           * Meetings                           * Highlight product information
  1209.           * Highlight investment opportunities * Advertise on disk
  1210.           * Customer information               * Tourist guides
  1211.           * Restaurant guides                  * Directories (Names, phone #s)
  1212.                             And on and on and . . .
  1213.  
  1214.          ==================================================================
  1215.          P-Screen // P-Screen Professional        QuickBASIC screen support
  1216.          ==================================================================
  1217.          P-Screen is a screen: "design," "library/database" and "display"
  1218.          system all in one.  Use it to design screens for programs you write,
  1219.          or for program demos, prototyping, word processing, batch files, etc.
  1220.          * Draw/Join lines or boxes, in several styles
  1221.          * Fill areas with shading, or Paint entire screens or selected areas
  1222.          * Enter text, auto-centered inside lines or boxes if you like
  1223.          * Quick, easy block options:  Copy, Move, Erase, Shade, Paint, UnDo
  1224.  
  1225.          Save/Load/Libraries
  1226.          * Save screens to or Load screens from Ascii files or Libraries.
  1227.            You can also save executable "Com" screens -- colors and all!
  1228.            - We include Capture to "grab" screens from other applications.
  1229.          * Libraries give you the convenience of 1 file to store up to 50
  1230.            screens -- in color, complete with names and descriptions.
  1231.  
  1232.          Using Libraries in Your Programs, Demos, etc.
  1233.          * We supply routines to display your screens from QuickBASIC
  1234.            programs (QB 3-4.x).
  1235.          * It's easy to write programs to access screen libraries.
  1236.            - You can load and display 1 screen at a time.
  1237.            - Or load 2 or more screens into arrays, then pop them up instantly.
  1238.  
  1239.          P-Screen Professional even writes your QB programs for you!!  And
  1240.          it comes with several other subprograms you can use in any program. 
  1241.  
  1242.  
  1243.  
  1244.          Other Programs by Pro~Formance  (continued)
  1245.  
  1246.          ================================================================
  1247.          The Survey Catalyst  (TSC; a commercial program, not shareware)
  1248.          ================================================================
  1249.  
  1250.          The Survey Catalyst is for anyone who works with attitude or opinion
  1251.          surveys.  It helps you create surveys in minutes or hours--not days!
  1252.           * TSC includes a database of thousands of survey items--like
  1253.             items used in most Fortune 1000 companies' employee surveys.
  1254.             - You can review items, edit them or add new ones.
  1255.             - OR, when you see an item you want to add to a survey, just
  1256.               press a key and add it--fast and simple.
  1257.           * And TSC's many printing options let you create "camera-ready" copy
  1258.             - Group items by Category, by Response Scale, or Randomize them.
  1259.             - Print response scales Above or Beside items (or not at all).
  1260.             - Print key punch instructions (or not at all)
  1261.             - Print a title--at the top or bottom of each page.
  1262.             - Or, print your survey "to a file"--to dress it up later.
  1263.  
  1264.  
  1265.          ================================================================
  1266.          Pro~Stamp        Stamp Collection Manager
  1267.          ================================================================
  1268.  
  1269.          Pro~Stamp is a full-featured assistant to manage stamp collections.
  1270.  
  1271.           * Pro~Stamp is very easy to use:  Pull-down menus, Extensive
  1272.             Help Screens, Calculations done for you, Select "Type" &
  1273.             "Condition" from menus.
  1274.           * Add information to "worksheets."  They're set up like most
  1275.             popular collectors' manuals (eg., Scott).  But we add
  1276.             "spreadsheet" convenience by doing calculations for you!
  1277.           * Track small to huge stamp collections, with ease and convenience
  1278.           * Multiple file options add flexibility.  Use different work-
  1279.             sheets for different subsets of your collection.
  1280.           * Spreadsheet convenience:  Automatically calculates the value
  1281.             of each stamp and its Increase/Decrease in value.  Calculate
  1282.             the value of your entire collection with a press of a key.
  1283.           * Sort your collection on any of several fields (Scott Number,
  1284.             Country, Value, Type, etc).
  1285.           * Print entire worksheets, or print a range you specify.
  1286.           * Customizable:  Configure fields your way, edit printer codes.
  1287.  
  1288.                                                                              
  1289.  
  1290.  
  1291.          ==================================================================
  1292.          Multi-Print (MP)                Also see Ram-Man on the next page.
  1293.          ==================================================================
  1294.  
  1295.          Multi-Print is an absolutely terrific program that lets you print
  1296.          text files (like this manual).  You can print text:
  1297.  
  1298.          * In LANDSCAPE mode on HP LaserJets OR Epson printers!
  1299.  
  1300.          * With 1, 2 or 4 pages of text on EACH sheet of paper!  In 4-page
  1301.            mode, Multi-Print prints on both sides of each sheet of paper.
  1302.            And MP prints up to 66 or 80 lines per page!
  1303.  
  1304.          * In "booklet" form, ready to fold and staple, or "left-to-right"
  1305.            ready to put in 3-ring binders, or in "1-column" mode (which
  1306.            is a great way to print spreadsheet or database data with up
  1307.            to 250 characters per line).
  1308.  
  1309.          Multi-Print includes three internal fonts!  Two are for LaserJets;
  1310.          the third lets MP print in landscape mode on Epson printers.
  1311.  
  1312.           * MP's "Times Roman" LaserJet fonts give you much higher quality
  1313.             output than is possible with the LaserJet's "line printer" font
  1314.             or with other programs.
  1315.  
  1316.           * And all three fonts allow MP to print most any ASCII character:
  1317.             French, German, control codes, lines, boxes, shading, etc.
  1318.  
  1319.             - Print lines, boxes, shading,arrows, "check boxes," "bullets"
  1320.               and other special characters.  Print titles, page #s, etc.
  1321.  
  1322.  
  1323.          Finally, MP gives you many other options to print text your way
  1324.          (margins, print titles, page numbers, the date, print to a
  1325.          file, and on and on).  It also is menu driven, supports a
  1326.          mouse, and saves all the options you choose so you don't have
  1327.          to select them manually the next time.
  1328.  
  1329.  
  1330.                                                                              
  1331.  
  1332.          ================================================================
  1333.          Ram-Man                   Also see Multi-Print on the last page.
  1334.          ================================================================
  1335.          Ram-Man is a RAM-resident (TSR) program to turn ANY text file
  1336.          into a pop-up quick-reference guide (or manual).
  1337.  
  1338.           * Pop up your text file while you're working in virtually any
  1339.             text-based (not graphics) program.
  1340.           * BROWSE through it.
  1341.           * SEARCH, looking for a topic or phrase you're interested in.
  1342.           * LOOK UP words, which we'll read directly from your screen!
  1343.  
  1344.          We supply the RAM-resident "engine," you supply the text.  Ram-
  1345.          Man preserves DOS memory by keeping ONLY its engine in memory.
  1346.          It displays your text from disk (hard or RAM disk recommended).
  1347.  
  1348.          You can change which file you're viewing without unloading
  1349.          Ram-Man.  That means you load Ram-Man once, then change ref-
  1350.          erence guides as your needs or the programs you use change.
  1351.                                            
  1352.          Now, regardless of which text-based program you're using (or
  1353.          even at the DOS prompt), you can have on-line, pop-up help
  1354.          available -- at any time, at the press of a key.
  1355.  
  1356.  
  1357.          Examples:       
  1358.           * The complete, on-disk manual for a program you're using.
  1359.           * A series of help screens or "Quick Reference Guides"
  1360.             (eg., tips on using DOS, tips on using a program).
  1361.             - You can display standard DOS text files, like those
  1362.               you create using an editor or word processor.
  1363.             - Or you can display special "screens" you create with
  1364.               programs like our P-Screen Screen Designer.
  1365.           * Appointment Calenders, To Do Lists. . . . etc.
  1366.  
  1367.  
  1368.          Other features:   (<R> = REGISTERED versions.)
  1369.  
  1370.           * BROWSE through files -- line by line or page by page.  And
  1371.             you can jump to the top or bottom of small -or- huge text
  1372.             files in 1/2 second or less.
  1373.  
  1374.           * SEARCH for topics relevant to your needs.
  1375.  
  1376.           * <R> "LOOK UP" reads a word directly off your screen THEN
  1377.             searches for it!  BE SURE to read the section on Look Up for
  1378.             uses (eg., Quick reference, spelling, thesaurus, quotations).
  1379.  
  1380.           * UNLOAD Ram-Man and reclaim the memory it uses.
  1381.  
  1382.           * <R>  RUN-TIME OPTIONS let you choose:
  1383.             - The "hotkey" you want to use to call Ram-Man up.
  1384.             - The size of the screen you want to use -- to let you
  1385.               switch between 25, 43 or 50 row screens at will.
  1386.             - The colors we use to display text.
  1387.  
  1388.               These options help ensure that Ram-Man's hotkey, colors
  1389.               and screen modes never conflict with the programs you use.  
  1390.                                                                            
  1391.  
  1392.                              T O   O R D E R   : : :
  1393.  
  1394.    F ______________________________________________ M   Rob W. Smetana
  1395.                                                         Pro~Formance
  1396.    R ______________________________________________ A T 132 Alpine Terrace
  1397.                                                         San Francisco, CA 94117
  1398.    O ______________________________________________ I O (415) 863-0530
  1399.  
  1400.    M ______________________________________________ L   Make checks payable to::
  1401.                                                            Rob W. Smetana
  1402.    Phone (      ) ______-________  Date ___/___/___
  1403.    (If ordering by credit card, be sure name is as it appears on your card.)
  1404.  
  1405.   ================================================================== spk 2.8 =
  1406.   Program                                 # of Copies  Price/Copy     Total
  1407.   ============================================================================
  1408.   P~F Presents / P~F Presents Professional _________    $49 / $79   $ ________
  1409.   P~F Form (PFD & PFM)                     _________       $49      $ ________
  1410.   Mail Call (Without / With MC Express)    _________    $40 / $49   $ ________
  1411.   Pro~Scribe & PS Express                  _________       $39      $ ________
  1412.   P-Screen (Plus / PS Professional)        _________    $29 / $49   $ ________
  1413.   Multi-Print                              _________       $39      $ ________
  1414.   Pro~Stamp Stamp Collection Manager       _________       $29      $ ________
  1415.   Ram-Man RAM-resident Reference Guides    _________       $18      $ ________
  1416.   Sparkle (gift/$15 for latest version)    _________    $10 / $15   $ ________
  1417.   The Survey Catalyst (TSC)/TSC Demo Disk  _________   $595 / $15   $ ________
  1418.   Protege  (Specify Age Range: ________ )  _________       $25      $ ________
  1419.   ============================================================================
  1420.      PACKAGE DISCOUNTS                    (Call about quantity discounts)
  1421.   ============================================================================
  1422.   Mail Call & P~F Form        (+ $4 s/h)   _________       $79      $ ________
  1423.  
  1424.   P-Screen Pro & P~F Presents (+ $4 s/h)   _________    $79 / $109  $ ________
  1425.   ($79 WITH / $109 WITHOUT our introductory copyright in PFP)
  1426.  
  1427.   The Works! 1 of each (exc. TSC, +$10 s/h)_________       $219     $ ________
  1428.  
  1429.   ============================================================================
  1430.        Shipping & Handling                         $3/copy US & Canada
  1431.      Total Number of Programs ----->>      _______ $8/copy Elsewhere $ _______
  1432.   ==========================+=================================================
  1433.                             |                             Subtotal  $ ________
  1434.                             |
  1435.   PAID BY:                  |     California residents, add 7% tax  $ ________
  1436.                             +-----------------------------+-------------------
  1437.                                                           |
  1438.    ___ Check  ___ MasterCard  ___ VISA                    |  TOTAL  $ ________
  1439.  =========================================================+====================
  1440.   *** Orders from Outside the US: International Money Orders, US Funds ONLY.***
  1441.  
  1442.   THE FOLLOWING IS REQUIRED for credit card orders (can't process order w/o it).
  1443.  
  1444.    Credit Card Number:  ______________________________    Expires: ___/___/___
  1445.  
  1446.    Signature (Required for credit card orders): ______________________________
  1447.  
  1448.           (Be sure your name at the top is as it appears on your card)        
  1449.